Skip to content

/v2/blueprints/{blueprint_id}/versions/
Stable

Request

Retrieves a paginated list of every version created for a specific blueprint.

Each blueprint can have multiple versions as its configuration evolves over time; this endpoint returns them all, with filters available for version number, publish status, and specific apps, files, or Wi-Fi networks referenced within a version's settings.

About Blueprint Versions

A blueprint's actual device configuration lives on its versions, not on the blueprint record itself. Versions let you iterate on a blueprint's settings (apps, files, restrictions, and so on) while keeping a history of what changed and when. Devices are converged to a specific blueprint_version_id, not just a blueprint_id, so this endpoint is the standard way to find the version currently in use or the version you intend to publish next.

Key Fields / Query Parameters

version_number — filters results to a specific version number

publish — filters by publish status

settings__android__app_id — returns versions that include the given app in their settings

ordering — orders results by one or more fields such as version_number or minor_version_number; prefix a field with a minus sign to reverse order, combine multiple fields with a comma

Common Use Cases

Finding the latest published version of a blueprint before converging devices to it

Auditing how a blueprint's app or Wi-Fi network settings have changed across versions

Confirming which blueprint versions reference a specific app before removing that app from the tenant

Best Practices

Filter by publish to distinguish draft versions from versions that are live and available for Converge

Use the settings__android__app_id and similar filters to find every version affected before making a breaking change to a shared resource

Workflow

Call this endpoint with the blueprint_id to list its versions

Identify the version_id of the version you need, typically the latest published one

Call GET /v2/blueprints/{blueprint_id}/versions/{version_id}/ for that version's full settings

Use the version_id in a Converge request to apply it to devices

Path
blueprint_idstring, (uuid)required
Query
orderingstring

Order the results by a specific field (-field for descending order), Combine Multiple with , like -version_number,-minor_version_number.

version_numberstring

Filter the results by version_number

publishstring

Filter the results by publish

settings__android__app_idstring, (uuid)

List the versions which have given app_id.

settings__android__app_version_idstring, (uuid)

List the versions which have given app_version_id.

settings__android__file_idstring, (uuid)

List the blueprints which have given file_id.

settings__android__wifi_network_idstring, (uuid)

List the blueprints which have given wifi_network_id.

settings__ios__provisioning_profile_idstring, (uuid)

Filter versions that have the given provisioning profile ID for iOS.

settings__ios__provisioning_profile_version_idstring, (uuid)

Filter versions that have the given provisioning profile version ID for iOS.

settings__tvos__provisioning_profile_idstring, (uuid)

Filter versions that have the given provisioning profile ID for tvos.

settings__tvos__provisioning_profile_version_idstring, (uuid)

Filter versions that have the given provisioning profile version ID for tvos.

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/blueprints/{blueprint_id}/versions/?ordering=string&version_number=string&publish=string&settings__android__app_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&settings__android__app_version_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&settings__android__file_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&settings__android__wifi_network_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&settings__ios__provisioning_profile_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&settings__ios__provisioning_profile_version_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&settings__tvos__provisioning_profile_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&settings__tvos__provisioning_profile_version_id=497f6eca-6276-4993-bfeb-53cbbbba6f08'

Responses

Success

Bodyapplication/json
contentobject
Response
{
  "content": {
    "count": 0,
    "next": "string",
    "previous": "string",
    "results": [ … ],
    "message": "string",
    "code": 0
  }
}